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INTRGOUCTIOM 



The AUS^E?^T Compose subsystem provides the capability to output 
documents stored in AliG^-EMT files on pyblicat lon-qyaU ty devices sucti 
as photocc!T5pos1 1 Ion units*- laser printers^ and Computer Output 
microform CCOH) recorders- It also provides facilities for proofing 
and verifying tlie page siakeup prior to final publication* The design 
of Compose is riodular^ allowing easy adaptation to many types of 
output devices. 



USING COMPOSE 

Typical Steps To Use Coipose 

In order to pyblisli e docuipent usin-g AySI*l€NT's COflPOSE sybsysteia^ 
the document must be In an AUGKEI^T file. The Sase subsystem of 
AUSil-ENT contains comffiands for Inserting and editing text in AUGMENT 
files. 

The forpiat of the published docusient Is controlled by *''Output 
Processor directives''. These are special text expressions which 
are Inserted at th^e appropriate place in the docutaent to control 
such aspects of document f ormat . as aiarglns^' Indentations^ spacing 
between lines and paragraphs^ running headers and footers^ and so 
on- The **Output Processor User's Guide' • describes the usage and 
effects of each of the available directives- The directives for 
docusient publishing through COFiPQSE are essentially the same as 
those for printing on workstation printers^ line printers^ or 
terminals. The main difference Is that when you use COHPOSE^ the 
** photocojjiposi tlon measure'' Ca value accurate to one thousandth of 
an inch) will be used for the directive valuer If provided- This 
alloys the accurate positioning which is needed for lEOst 
publication tasks. 

yhen you have a document prepared with the desired format 
d1 recti ves# the next step is to use the Compose subsystem Layout 
coiiiRand to produce a ** layout file*'- A layout file is a special 
type of filer not readable through normal AUSIIENT or Exec commandsj' 
which contains an encoded representation of each pa§e of the 
docufient- The layout file specifies fonts/- character sizes*- 
lineyork data^ and exact location on the page for each textual or 
graphical entity on each page- 

At this pointy you should use one of the Coinpose facilities for 
examining the page layouts in the layout file- Often you will find 
mistakes in the format specification or see places where the 

appearance of the docuif^ent can be improved- Compose provides two 

ways of doing this: 



The CoafipQS-e sybsystein Proof facility requires the yse of a 
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Senisco €-1000 or Tektronix 4014 high-resolution display. Such 
a terFiinal is typically connected to the **print€r'' connection 
on an AUGHEMT display terminal. Text and graphics are portrayed 
on the high-resolution display in their correct relative 
positionsr one full page at a tinse- Compose proofing coiaiaands 
alloy displaying any page in a layout file and printing the 
screen iisage on an attached hardcopy unit- This is the fastest 
way to review the format of a docunent^ and yill generally foe 
the iiethod of choice in pyblishing applications of any 
substantial volume. 

The Describe facility produces a **descript ion* ■ of the pa-ge 
layout of any or all of the pages in a layout file. The 
description Is typically printed on an ordinary alphanumeric 
orinter. It gives the full details of the fonts# character 

sizes-f and page coordinates of each line of text^ all printed 
out 1n text forin. This information is more exact than the Proof 
display.^ and should be exaisined in any case where details of 
positioning are critical^ or to verify font usage if you are 
unsure of the effects of the font directives in the docuiaent- 
Also/ this capability alloys AUGMENT users not ecjuipped with 
display units suitable for Proof to carry out occasional 
publishing of saall to mediuni sized documents. 

yhen a satisfactory layout file has been produced for the docusent^ 

the Compose suosysteir* Translate command is used to create the file 
that yill be input to the photocoMposition unit# laser printer or 
com recorder- COMPOSE will deteriaine the correct forfflat file 
format to use for the output unit specified in the user's profile 
or in the Layout commands and the appropriate data for input to 
that unit yill be placed in a translation file- This file can then 
Pe transferred to the output unit by appropriate means (usually by 
writing It on a inagnetic tape). 

The next three sections of this document explain the layouts 
revley^ and translation steps in more detail- 

Haking the Layout File — The Layout Coatiuand 

All the puPlishing functions of Compose york on layout files- The 
Layout comiand n^akes a layout file frosi an AUGHENT file or part of 
a file- Ihe full syntax of the Layout command is: 

Layout [(using view) VlSySPECSl STRUCTURE (to) 

File (to be named)/ Ape end (to file) COHTEI^T LAYOUTOEVICE/OK 

Certain format defaults are based on the vieyspecs in the current 
file yindoy. If the optional viewspecs are provided in the Layout 
tommandf they will be used instead- Explicit directives within the 
STRUCTORt will override corresponding viewspecs# regardless of 

their' source. 
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If **File*' 1s speclfled/^ a neu file (or new versloTj) Is created. 
Specifyirsg an existing version of an existing file is an errors 
even if that version Is deleted (but not expunged). If ^*kppen4** 
Is specified and there is not an existing undeleted file with the 

soecified n^^jmeA an error is indicated- **Append"" may not york for 
so©e device types; ask oefore using it« 

The layout is produced to fit the capabilities of a particylar 
output device- For LAYOUTDEVICE^ typing <0K> selects the default 
device froiB your profile. Give the coftiuand word "Device" to 

overri de .the prof lie and specify the device. 

LAYOUTDtVICE = Device DEVICE (model) mt^EL (at vendor) VEI^DOi 

For DEVICE^ the devices currently supported yill be available as 
command «ords- Once you have chosen a device*- you laay have to 

specify for f^fODSL a co!R.mand «ord for the model of that device. If 
that device and model are supported at more than one vendor^ you 

have to specify which one for the command word VENDOf?. 

The choices available are controlled by the **index file*'. 
Normally the index file will be a system file supplied «ith 
AliSHSNT- In some special customer installations^ the index file 
ffay be under the control of local systems managers or individual 
users. This 1s discussed under * *Conf iguring Compose for 
Special Installations*". 

^'Messages have been entered in log" 1s displayed at comiiiand 
completion if a directive specified a type face qt size which is 
not availaole on the device. The messages will tell what was used 

instead. These messages are placed in the file named 

I^OTIf ICATIOI^S-IDENT (where inEni stands for the user»s ident) in 

the login , directory. 

Reviewing the Layout File — The Describe and Proof Coiaaiands 

Describing, a Layout, 

The Describe cofRi7?and in Compose generates a description of a 
layout file in a special format which tells exactly where each 
element of the page layout is located and what typographic 
specifications will be used for setting type on the output unit. 
You can print this description on several types of devices and 
you can give a wide variety of specifications to control how the 
description should be printed. The syntax of the Describe 
co'siffsand Is: 

Describe Layout (from layout file nassed) COI^TENT (on) 
OK/DHVICETYPE (specifications:) OK/OEVICESPECS 

,Chc1c€s for DEVICETYPE are: yorkstation (prin,ter)# Terminals 
LlneDrinter/ or File. Typing <0K> at this point selects the 



device specifiec by the Base profile feature **pr1nt# default**. 
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Device type yorkstatlon (printer) creates a workstation 
printer f1l-e in the Base profile specified directory for 

yorkst3t1on printer files. 

Device type Lineprinter creates a line printer file in the 
Base Drofile specified line printer directory an4 it is 

autoinatically printed by the tine printer despooler. 

Device type Terssinal causes the description to be printed 
1-ijffiedi at ely on the terminals which usay be a^ display or 

typewriter type terminal. 

Device type File creates a sequential file containing the 

description teit- 

Available DEVICtSPECS for each D£VICETYP£ are listed beloM. The 
meBninQ of Segin an^ End in the Describe coa^mand is different 
from that in th-2 Base Print cominand; this is explained belo«. 
All other D£VIC£SP£C3 have the same interpretation as in the 
Base Print cofninand- For all DEVICtSPECS that you do not 
specify^ you '.(*ill get the default indicated in parentheses- 
Workstation (printer): Segin C1)> Copies <1)# End (the end}^ 
Hold (don't hold)/- Priority (noruiaD^ Queue <no'>^ yait Cno) 

Lineprinter: Begin (1)^ Copies (D^- End (the end) 

Terminal: Segin (1)# End (the end)# Foriafeed (simulate with 

linefeeds)/- yait (no) 

File (to be naired): 8egin (1># End (the end} 

The meaning of Begin and En^ specifications in the Describe 
coffiinand is slightly different from that in the Base Print 

command; this is explained below. All other DEVICESPECS have 

the same interpretation as in the Base Print cojamand- 

Segin (on page) COHTEi^T: The description will begin «ith the 
page that you specify for CONTENT- AUSflEMT calculates where 
tc start the description by assuming the first page in the 
layout file is page 1 (regardless of the page numbers in the 
photocoroposed document or the nunsber of pages in the printed 
description)^ counting until it reaches the page you 
specified- The description begins with that page- 
End (on Ddqe} tQUJEHlz The description yill end on the page 
that you specify for CO-NTENT- AUGHEfIT calculates where to 
stop the description by assuming the first page in the layout 
file is page 1 (regardless of the page numbers in the 
photocomposed document or the number of pages in the printed 
description)^ counting until it reaches the page you 
specified- It stops generating a description when that page 
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Proofing a Layout 

The Proof cofn-mand In Cofflpose interprets the layout file you 
specify and displays a visual reproduction of the pages of the 
layout .file on a graphics display (ysually attached to an 
AUCHtNT workstation). This visual reproduction shows 
Daqinationr line breakage^ the vertical placefRent^ and the 
justification of the line on the page- (asterisks on lines set 
flush left or flush right indicate that the full text appearing 
in the line cannot be fully displayed). The syntax is: 

Proof Layout (file nased) COI^TENT OK 

The first cage of the layout file is displayed autotnatically as 

part of the Proof co^fsand- 

If no extension is supplied with the layout file name^ -LAYOUT 

will be 3ssu?!5ed« 

Typing <CTRL-0> on the yorkstation keyboard during page iffiage 
creation causes paqe display creation to halt- The coi^aand 
prompt Mill be displayed ana the user inay give any Coiapose 

conimand desired. 

After the Proof coiainand is §iven# the folloying coroflnands laay be 
used to display other pages in the layout file in any order- 

BaC'k (one page) OK 

Displays the p^aq^ preceding the one currently displayed. 
Next (page) OK 

Displays the page following the one currently displayed. 

Skip (to) SackMard (number of pages) CONTENT OK 

The Skip (to) Backyard command in Corapose displays the 
page that is a specified number of pages closer to the 
beginning of the layout filej' counting from the current 

p 3 9 ^ • 

Skip (to) first (page) OK 

The Skip (to) First command in Coinpose causes the first 
page of the current layout file to be displayed- 

Skip (to) Forward (number of pages) CONTENT OK 

The Skip (to) forward comnand in Coripose displays the page 
that is a specified number of pages closer to the end of 
the layout file^ counting froiTs the current page. 
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Sklo (to.) Last (page) OK 

The Skip (to) Last command in Compose causes the last page 

of the current layout file to be displayed. 

Skip (to) Page COMTEHT QK 

The Skip (to) Page cowman^ in Compose causes the page you 

specify tc be displayed- The first pa^f^e in the layout 

file is considered to be -oage 1r whether or not it bears 
the number l^. 

If the graphics display has an attached printer^ the Print 
coiTiJisand may be used to print all pages when displayed^ or to 
print specific ones once« _The profile feature "printer delay 
secorsds" should be correctly set before using Print. Here are 

the forms of the Print command: 

Print Every (page autopatically) OK 

The attached printer will print the pages currently 

displayed by Proof every time you change the page 
di splayed- 
Print f^one (automatically) OK 

Undoes the effect of the Print Every (page automatically) 

co-ifiiand- It does not prevent you fron using the Print 
Rest or Print Pages coffluiands or the "print" button on your 

■graphics display device- 
Print Rest (of pages) OK 

The current page is printedi? then each succeeding pa-gs in 
the Layout file is displayed and printed one after 
another/- until the end of the layout file is reachedm Hay 
de cancelled at any time by typing <CTRL-0>« 

Pages: Print Pages (froiE) CONTENT (through) COf^T€?IT OK 

Beginning with the first page number specified/- each page 
in the layout file is displayed and printed automatically^ 
one after another^ until the second page number you 

specify has been , disp layed and printed- -^ay be cancelled 
at any tirse by typing <CTRL-0>. 

Before ysing Proof the first timer the Cofflpose profile features 

"proofs display devices type" and "proof/- display device^ setup" 
should be verified as being correct for the graphics display 

conf i quration- 
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Trans Lating the Layout file -- The Translate Command 

In generals each type cf phototypesettter^- COM recorder^ and laser 
printer has a unique format for Input data- furthermore^ different 
fpachines of fhe same fsodel belonging to different users or service 
bureaus (** vendors '" ) usually have different type sizes and styles 
available. The Compose subsystem Translate coaimand takes one or 
more layout files anc produces an input file acceptable to a 
particular device^ models and vendor/user. The general syntax of 
the two main forius of the Translate coma^and is: 

Translate Layout Cfile naiBed) CONTEI^T (for) 0UTPUTDE3T 

(specifications:) OiC/D£VIC£SP£CS 

This translates one layout file. 

Translate Multiple (layout files - <OIC><OK> after last) COMT£f»IT 
... CONTENT OK (for) OUTPUTDEST (specifications:) OK/DEVICESPECS 

This translates ail layout files as though all the pages were 
i n 3 s i n g I e I ay o u t , file. 

Availaole oyTPUTDSST command words are: 

Vend-or 




Translate Layout (file named) CDMTE^IT (for) Vendor File 

(to be nained)/Apoend (to file) COI^'TEMT (specifications:) 

OK/DEVICESPECS 

Translate l^yltiple (layout files - <OK><OK> after last) 
COI^TENT (for) Vendor File (to be na!Bed)/Append (to file) 
COIITENT (specifications:) OK/DEVICESPECS 

Available DEVICESPECS for destination Vendor are listed 
beloM. for all 0EVICESPECS you do not specify*- you «ill get 

the defaults indicated in parentheses. 

Begin (on pace) CONTENT (page 1) 

The translation will begin with the page specified for 
CO^TE^T. m^ntUJ calculates where to start the 

translation by assyming the first page in the first 
layout file is page 1 (regardless of the page numbers 

in the photocomposed docu!Bent)# then counting until it 

reaches the page specified- 



md ion.QBQe) tOWTEUT (last page) 
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The translation will end at the end of the pa^e you 
specify- AUSI^ENT calculates yhere to stop the 
translation by assuming the first page in the layout 
file is page 1 (regardless of the page numbers in the 
ohotocomp'osed docu-ment ).r then counting until it reaches 
the page specified. 

The default extension for the translated file is .TRAMS, 
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rocessor In Progress'* is displayed yhen the 
ins successfully. yhen translation is 

essage *" Finished - no notifications logged'* 
ppear. The message ** Messages have been 
" is displayed instead if the layout file 
ypographic specification not available on the 
ssages yi II tell what -^as. used instead. These 
aced in the file named NOTIf ICATIOHS-IDEflT 
andSr for the user's ident) in the login 
s should happen only if the file containing 
he device has been changed since the layout 
d- If this message occurs unexpectedly^ 
£^ the vendor^ or whoever maintains the 
at device^ for inforaation and advice. 



Rast erprint er# yorkstation^ Terminal 

The current version of kU-QKEMT does not support these output 
destinations. They will be supported in a future release of 

AIJ6MEMT- 

TYffSHARE provides the files Bn^(^ programs used by Cotupose to make 
this work yith certain installations- Therefore^ users laust do one 

of t.he following: 

Make arrangenents to use a TYI*fSI^AR£ supported service bureau. 

Contract i^ith TYHSHARE for full support of the device they yish 

to use. 

Acquire th-e use of a supported device and provide font data 
ne^d^e^^ to set up the font mapper data file. 

Provide their own interface (see **Conf i our ing Compose for 

Speci a I Usage' ' ') - 



In any caser the final file is sent (usually on tape) to the 
devi ce. 
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CONFISURII^S COMPOSE FOR SPECIAL USAGE 

Customer Osvelooed Interfaces 

Compose 1 s designed to allow customer Installations or individual 

users to touild custc??? interfaces which can be accessed by nornsal 
Compose commands- Vhenever Conpose is to be used with a parti cylar 
device installation^ two modyles roust be provided- There nust be a 
font sapper data (FI«D) file containing the specification of 
available fontsr .character width data^ character value translation^ 
and so forth. This yill generally be different for every site# 
even If the same uiodel of device Is being used. There myst also be 
3 translation processor to translate a standard AUGMENT layout file 
Into the appropri ate input format for the device. This will 
■usyally be the sane for different installations with the saase siodel 
of output device- 

In consequence/- it is considerably easier to interface Cojspose «ith 
a device of a tyce already supported. All that is needed is to 
preQ^re the ffiD file^ which is used by the Layouts Bescribe^ and 
Translate commands- The Font tapper document listed in the 

References specifies the format of the fnt> file. Customer provided 
fK& files can be added to AUSI*?£NT at no extra cost. Special 
arrangements iprobabiy at extra cost) must be laade if the font data 

is supplied in some other form. 

To interface to a device not already supported*- a translation 
processor -must also be written. A translation processor is a 
orograiu of non-trivial^ but not Iffliuense^ scope. The docusjents 

mentioned in the References contain sufficient information for a 

proqraiRi?5,er proficient in the LIO language to write one. 
Nevertheless^ customers intending to do this are advised to .contact 

the AUG^ISMT .Development Unit before beginning. 



Linking .Interfaces .with Cois-pose 



The connection between device^ model/- and yendor names and fHD 
files and translation processors Is established by an AUS'f^ENT file 
called the **index file." The systein default index file is 
located in the release directory Cnorisally U8£L> and is called 

C0!1-!>f^V-DATA,AU6. Beginning with AUGHEMT version 10.14/' a 
capability exists for a user to specify a different index file via 
a Coinpose subsystem profile feature- The index file is structured 

in the following yay: 

The name of each legal device type is placed in a first level 

Stat -eiTfent - 

The name of each ^odel of each type of device is placed in a 
second level statement below the device. This fflust be done even 
If there is only one legal value for the **model'*. 
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The .name of each vendor Cor, user) of a given device and isodel 
must be placed In, a third level , statement beneath the device and 

mode I . 

Under each third level (vendor) stateiaent Is a ptex at level 4 
containing the Interface module fllenaines In operating systein 

format. At pressnty two such nodules are defined; thus two 
fllenaffles must be provided- If no directory Is specified^ the 
current release directory Mill be assumed at execution tliue. 

Tlie first fourth level statement must contain the fllenaise of 

the appropriate translation processor program. 

The second fourth level state^ment must contain the fllenasie 

of the appropriate ¥Ht> file. 

All device^ ff!Odel# an4 vendor names should consist only of 
printable characters,. There should be no "** stray'' characters 
anywhere in the file (except for the origin stateiaent^ yhich may 

contain anything at all). 

The TYMSHARE-suppli ed FfID files and translation processors are 
located in the AU-S?!€:fyT release directory. Sources for each are In 
the directory OPSRC en those systems yhere sources are supplied. 



COHPOSE Pft06«AttllING REFEREHCES 

The following docuinents contain the additional design Information 

neQ-de^d to program an Interface between COf'SPOSE and an output device.. 

Layout File Format <pr,ogdocs/' layout-file^ :Mh>, 

Describes the internal forasat of the layout file. This is 
necessary inforiiiation for prografflinlng a translation process. 

Font Rapper Kprogdocs*' f ont -mapper *- :wh> 

Describes the Font tapper software and defines the foTBsat of the 
font inapper data file. In , generals a, font, mapper data file Is 

needed for each d„evice with .which COMPOSE is to ,be used. This 
document also contains Inforiaation about how to set up font data 

specifications that can be processed by the FONTLOAD subsysteai to 

produce the' font mapper data file. 

Translation Processor Interface <progdocs# translation^ :wh> 

Descrioes the interface protocol yhich must be employed to allow a 

translation processor to be used by the COMPOSE Translate command. 



